home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / dev / c / libiconv.lha / readme.amiga < prev    next >
Encoding:
Text File  |  2000-11-21  |  2.0 KB  |  57 lines
  1. this is libiconv 1.4
  2.  
  3. I've ported it with gcc and it's a compiled with -noixemul
  4. so it doesn't require ixemul.library
  5.  
  6. I've added 2 things to the library
  7.  
  8. 1) a function called get_locale_charset();
  9.     this function requires 
  10.         either of these vars
  11.         1) LC_ALL
  12.         2) LC_CTYPE
  13.         3) LANG
  14.     Recall that a locale specification has the form
  15.   language_COUNTRY.charset
  16.  
  17.     I'm using LANG and have it set like this
  18.     sv_SE.ISO8859-1 I also have it sometimes set like this
  19.     sv_SE.ascii
  20.     
  21.     const char* get_locale_charset (void)
  22.     the function returns the 'codepage' that the current user is using
  23.     (well you get the idea :-)
  24.  
  25. 2) a function called iconv_string
  26.     This C function converts an entire string from one encoding to another,
  27.   using iconv. Easier to use than iconv() itself, and supports autodetect
  28.   encodings on input.
  29.  
  30.     int iconv_string (const char* tocode, const char* fromcode,
  31.                       const char* start, const char* end,
  32.                       char** resultp, size_t* lengthp)
  33.  
  34.   Converts a memory region given in encoding FROMCODE to a new memory
  35.   region in encoding TOCODE. FROMCODE and TOCODE are as for iconv_open(3),
  36.   except that FROMCODE may be one of the values
  37.      "autodetect_utf8"          supports ISO-8859-1 and UTF-8
  38.      "autodetect_jp"            supports EUC-JP, ISO-2022-JP-2 and SHIFT_JIS
  39.      "autodetect_kr"            supports EUC-KR and ISO-2022-KR
  40.   The input is in the memory region between start (inclusive) and end
  41.   (exclusive). If resultp is not NULL, the output string is stored in
  42.   *resultp; malloc/realloc is used to allocate the result.
  43.  
  44.   This function does not treat zero characters specially.
  45.  
  46.   Return value: 0 if successful, otherwise -1 and errno set. Particular
  47.   errno values: EILSEQ and ENOMEM.
  48.  
  49.     Example:
  50.     const char* s = ...;
  51.     char* result = NULL;
  52.     if (iconv_string("UCS-4-INTERNAL", "autodetect_utf8",
  53.                      s, s+strlen(s)+1, &result, NULL) < 0)
  54.       perror("iconv_string");
  55.  
  56. Jan-Erik Karlsson
  57. trg@privat.utfors.se